Quick Start
To get the base SDK loaded and running, you’ll need to:
Import the SDK
Bluedot Point SDK for Android is integrated into an application project as a Gradle dependency. Follow the steps below to integrate the SDK into your project.
1. Edit the root build.gradle
file to include a JitPack entry in the repositories section.
...
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
2. Include the Bluedot Point SDK as a dependency in the app’s build.gradle
file within the dependencies section.
dependencies {
...
implementation 'com.gitlab.bluedotio.android:point_sdk_android:16.1.0'
}
Manifest requirements
In order to receive Bluedot service error events after initialization, a class that implements BluedotServiceReceiver
should be implemented and registered in the AndroidManifest:
class ExampleBluedotServiceReceiver : BluedotServiceReceiver() {
override fun onBluedotServiceError(error: BDError, context: Context) {
// Handle error here.
}
}
<application android:label\="@string/app_name" >
<receiver
android:name="<path to your BluedotServiceReceiver implementation>"
android:enabled="true"
android:exported="false"
>
<intent-filter>
<action android:name="io.bluedot.point.SERVICE" />
</intent-filter>
</receiver>
</application>
Initialize the SDK
Now that the project has been set up, should initialize the Bluedot Point SDK from your Application class’s onCreate
function with:
ServiceManager.getInstance(this).initialize("myProjectId",
(error) -> {
// Handle initialization result
});
At this point, you’ve got the basics together, but to get value from the SDK you’ll need to start getting location events – you can do so by using our Geo-triggering or Tempo features.